Installation Kyocera Control Messenger
Kyocera Control Messenger is installed on the workstations of the users. An MSI installation package is available for installation of the Messenger, which can also be installed without user interaction (silent).
The separate installation package for the Kyocera Control Messenger can be downloaded at Download.

Kyocera Control Messenger can only be installed under Microsoft Windows 7 or higher.

Follow the steps of the installation dialog sequence, which is largely self-explanatory. In the Installation Settings dialog, enter the IP address or the hostname of the NotificationService (this is usually located on the computer of the Kyocera Control server installation). It is also possible to enter a backup printer for local print forwarding (optional); to allow this, Messenger must then be set up as a print proxy. The hostname and backup printer are entered in the LocalService.config file automatically. You can also change the entries here later.

You can perform the installation without user interaction via the command line. Required parameters can be transferred.
Parameters:
- SERVERNAME : Hostname of the server on which the NotificationService is installed.
- BACKUPHOST : Hostname to which the print should be forwarded in case of an error.
- REMOTEHOST : Hostname of the server on which the PrintService is installed.
- INSTALLFOLDER : Installation directory (without this parameter, the default directory C:\IQ4docs\Messenger is used).
-
INSTALLDESKTOPSHORTCUT: Creates a desktop shortcut (can be set to "true" or "false").
Example (the IQ4docs installation is located completely as a cluster on the servers printserver1,printserver2,printserver3):
msiexec /i MSEMessenger.msi /qn INSTALLFOLDER="c:\Messenger" SERVERNAME="printserver1,printserver2,printserver3" BACKUPHOST="KM3252ci" REMOTEHOST="printserver1,printserver2,printserver3" INSTALLDESKTOPSHORTCUT="true"

Configuration of the Messenger is done in the LocalService.config of the Messenger.

- MandatorGuid: Client GUID when operating in a client environment (otherwise empty).
- MultipleInstances: Specifies whether multiple instances of the Messenger should be started on one computer. By default only one instance may be started (false). Several may only be started for test purposes (true).
- WebClientUrl: Enter the URL for the call of the WebClient here - the WebClient can be called via the Messenger context menu. If this URL is not set, the menu item Open WebClient is grayed out.
- DontUseNlogMongo: With this setting you can prevent (true) or not prevent (false) logs being written to MongoDB - the logs should only be written to MongoDB for debugging purposes (default true).

- SkipDefaultPrinter: If Messenger is used to connect printer queues, it is possible to specify whether the user's default printer should be kept (true) or not (false).
- KeepExistingPrinters: If Messenger is used to connect printer queues, it is possible to specify whether all of the user’s printers that are already connected should be kept (true), or whether all existing printer queues should be removed (false).

- MqttPortList: Messenger communication ports with the NotificationService (standard 1883,1884).
- MqttNodeList: List of hostnames on which a NotificationService is running.
- MqttUserName: Technical user for technical communication (standard mqttsystem). This entry must match the entry in the LocalService.config of the NotificationService.
- MqttPassword: Password of the technical user for technical communication. This entry must match the entry in the LocalService.config of the NotificationService.
- MqttEncryptionKey: Key for transmission using encryption. This entry must match the entry in the LocalService.config of the NotificationService.

It is possible to set up Kyocera Control Messenger so that it is responsible for the transmission of print jobs (print proxy). This enables Messenger to forward the print job that has been initiated to a directly connected network printer in case the connection to the NotificationService is lost. The printer can be specified via the LocalService.config or via the installation query or can be stored in the WebAdmin for the client PC. See Direct printer
The following entries must be set in the LocalService.config of Messenger:
- ProxyRemoteHost: Hostname of the PrintService to which the print data are to be transferred.
- ProxyRemotePorts: Ports on which the print service receives the print jobs (incoming print), e.g. 49500,49501)
- ProxyLocalPorts: Local ports to be opened by the Messenger to accept a print job from a local printer driver (comma separated list). The first entry of the local port is forwarded on the first entry of the ProxyRemotePort, the second entry on the second entry, etc. (the number must match, e.g. 49500,49501).
- ProxyRemoteUrls: A print job received on one of the ports entered under ProxyLocalPorts can also be forwarded to the server via IPP or IPPS. For this purpose, a list of IPP URLs is specified at ProxyRemoteUrls (e.g. ipps://server/PrintService/ipp/Standard, ipps://server/PrintService/ipp/directprint). The number of entries must match the number in the ProxyLocalPorts list.
IMPORTANT: If forwarding to remote URLs is required, the ProxyRemotePorts list must be empty. - ProxyBackupHost: If the print job cannot be sent to the PrintService specified under ProxyRemoteHost, it is sent to the ProxyBackupHost (on the ProxyBackupPort or the ProxyBackupUrl).
- ProxyBackupPort: Port on which the print job is sent to the ProxyBackupHost.
- ProxyBackupUrl: URL to which the print job is sent if sending to the ProxyRemoteHost or ProxyRemoteUrl failed (e.g. ipps://backupserver/PrintService/ipp/Standard).
IMPORTANT: If forwarding to backup URLs, the ProxyBackupPort must be empty.
Example:
<appSettings>
<add key="MandatorGuid" value=""></add>
<add key="SkipDefaultPrinter" value="false"></add>
<add key="KeepExistingPrinters" value="false"></add>
<add key="WebClientUrl" value=""></add>
<add key="DontUseNlogMongo" value="true"></add>
<add key="MqttPortList" value="1883,1884"></add>
<add key="MqttNodeList" value="W2019STD01.domain.local"></add>
<add key="MqttUserName" value="mqttsystem"></add>
<add key="MqttPassword" value="UrkcOpnU3G4CrUjvOrZPzA=="></add>
<add key="MqttEncryptionKey" value=""></add>
<add key="ProxyRemoteHost" value="W2019STD01.domain.local"></add>
<add key="ProxyRemotePorts" value="49500,49501"></add>
<add key="ProxyRemoteUrls" value=""/>
<add key="ProxyLocalPorts" value="49500,49501"></add>
<add key="ProxyBackupHost" value="172.16.6.208"></add>
<add key="ProxyBackupUrl" value=""/>
<add key="ProxyBackupPort" value="9100"></add>
<add key="MultipleInstances" value="false"></add>
</appSettings>